home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 12 / BBS in a box XII-1.iso / Files / Bus / S / S7P 3.6 Manual.sit / S7P 3.6 Manual.rsrc / TEXT_132.txt < prev    next >
Encoding:
Text File  |  1993-11-14  |  2.7 KB  |  41 lines
  1. AddrToString
  2.  
  3. Err:=AddrToString(Target;ATLocation;Name;Port)
  4.  
  5. Converts a target address returned by MakeAddress, SelectAddress, or GetReturnAddr into strings which may be saved between sessions. ATLocation describes the machine's network identity and will be a string something like 'Mike:PPCToolBox@*'. It will be an empty string if the program is running on your local machine. 'Name' is the actual name of the program. Port is a PPC Toolbox port ID (usually the creator ID followed by "ep01").
  6.  
  7. DisposeAddress
  8.  
  9. Err:=DisposeAddress(Target)
  10.  
  11. Disposes the target address handle that was previously allocated with MakeAddress, SelectAddress, or GetReturnAddr. This is assumed to be a handle to an address descriptor. Since this is passed to DisposHandle, the system may crash if this isn't a valid handle. Note that DisposeAddress is the same as the new low-level function DisposeDesc, but has been kept for compatibility with older versions.
  12.  
  13. MakeAddress
  14.  
  15. Err:=MakeAddress(Signature;Target)
  16.  
  17. Creates a target address from an application signature. The application must be running on the local system. You must not modify this value in any way and should call DisposeAddress when you're finished using this handle.
  18.  
  19. SelectAddress
  20.  
  21. Err:=SelectAddress(Prompt;Signature;Target)
  22.  
  23. Opens the PPC Browser window, which allows you to select a program on your system or on a remote system to send AppleEvents to. If prompt isn't an empty string, it will be used instead of the default "select a program to link to" message. If the signature is an empty string, all programs will be listed. Otherwise only programs matching that signature will be listed. If this function returns 0, a handle to an address descriptor will be allocated and placed into 'target'. You must not modify this value in any way and should call DisposeAddress when you're finished using this handle.
  24.  
  25. Example:
  26. _________________________________________________________________
  27.  if (SelectAddress("Select a copy of Hypercard:";"WILD";$Target)=0)
  28.      $err:=DoScript($Target;"Go To Stack 'my stack'")
  29.      $err:=DoScript($Target;"Go To Next Card")
  30.      $err:=DoScript($Target;"Print Card")
  31.      $err:=DisposeAddress($Target)
  32.  end if
  33. _________________________________________________________________
  34.  
  35. StringToAddr
  36.  
  37. Err:=StringToAddr(ATLocation;Name;Port;Target)
  38.  
  39. Creates a target ID from a set of strings describing it. This is the complementary function to AddrToString. ATLocation describes the machine's network identity (should be an empty string if the program is running on your local machine). Otherwise, it will be a string like 'name:PPCToolBox @ zone'. Name is the actual name of the program. Port is a PPC Toolbox port ID, which is the 4-letter creator ID (it‚Äôs actually the creator ID followed by ‚Äúep01‚Äù, but the creator ID alone is allowed).
  40.  
  41.